Saves the user’s screen configuration preferences.

OSErr DMSaveScreenPrefs (
    UInt32 reserved1, 
    UInt32 saveFlags, 
    UInt32 reserved2
);

Parameter descriptions

reserved1

Reserved for future expansion. Pass NULL in this parameter.

saveFlags

Reserved for future expansion. Pass NULL in this parameter.

reserved2

Reserved for future expansion. Pass NULL in this parameter.

function result

A result code.

DISCUSSION

Usually when you change screen properties such as pixel depth, the changes will only be temporary and will usually reset after restarting. However, the function DMSaveScreenPrefs makes the current screen properties permanent.

SPECIAL CONSIDERATIONS

Because this function may move or purge memory blocks or access handles, you cannot call it at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when Displays 2.0 or later is present.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)